More on 
Debugging 



Lisa Stack Frame information 



Reg ister Usag e: 

DO - D2 and AO - A1 
D3 and AO - A2 
07 and A3 - A4 



DO 
04 
A5 
A6 
A7 



Can be used as user temporaries by your procedure 
Used for compiler temporaries 
Compiler uses for locals and pointers 
Pointer to global stack frame (for main program) 
Pointer to current local stack frame (current procedure) 
Pointer to the top of stack (Supervisor if domain * otherwise user) 



4 byte pointers 



One entry for each intrinsic unit, 

each entry = address of start of 

intrinsic global variables for 

that intrinsic unit. 



Global Stack Frame: 



^^t 



7 




Six byte junos. betteen segments. 



• Junps to procedures in another 
:': *9Ww!# ! t*g. MM or a ' : 



:v:::Size Of table depends on :J : g: : : 

: 'wte'.w* Jfw?.v .Y9MJ . 'www- 



Stack grovs down from high address to low address 



High Address 



Table (512 



Junp Table 



It 



Seonent Table (loader info about where segments are) 



]> fixed Size 



Data Pti Table (512 bytes, up to 128 intrinsic units) 




Shared hain (Global) Parens, 256 bytes, systen use 



Private hain (Global) Parens, 256 bytes, systen use 



hain Progran Globals 



Regular Unit Globals 



Intrinsic Unit Globals 



/First global variablt in nain 
progran is offset f f f f f f f f f ron A5 



7 



m is offset 




> Link A5,#... 
^> Cofmon Size 
• Sun of Areas Referenced 



Oynanic Stack Area 



32K Hex for both combined 



32K Wax for each intrinsic Unit 



Includes regular unit nethod slice tables 
Includes intrinsic unit nethod slice tables 



Local Stack Frame (usual oase ): 

High Address 



M •> 

(Stack frene 
in stack Crwl) 



AT 



Function Result (0, 2 or 4 bytes) 



Parameters (I bytes depending on parancter list) 



Static Link (for local procs only, franc proc defined in) 



Return Address (To procedure that called this procedure) 

Old A> (frawe of procedure that called this procedure) 

Local variables of this procedure 



Compiler Tenpories for this procedure 




> 



meter is always Sfif it this 

is i ClsscsJ tethod. 



Oynanic Stack Area 



Low Address 



Parameter Information: 



nfo passed for Paranetric Procedures and Functions: 



Address of procedure body 



Static Link, value » if this is not a local procedure 



Stack Frame of TSamView. MousePress: 



A7 

Before call to 
HousePress 



High Address 



A6 



(Stack Frawe 
in Stack Craul) 



During HousePress 



Address of nouseLPT 



SELF 



Return Address (To procedure that called HousePress) 



Old A6 (Frawe of procedure that called this procedure) 



Copied local version of 



nouseLPT paraMter 



panel 



plckSelection 



pickedBox 



sketchSelection 



thexind 




local Variables 



Dynanic stack Area 



Low Address 



Local Variables Assigned to Registers in TSamView. HousePress 

panel = A3 pointer to UABC globals = A4 

sketchSelection = 06 pickSelection - 05 

theKind = 07 



Using LisaBua in the ToolKit — Clascal Environment 

Itovina Around Stack Frames 

You can use the following information about stack frames and register usage 
while debugging in the ToolKit environment. The Global stack frame is the 
stack frame for the main program. There is one global stack frame for each 
process. All other procedures, functions and methods have a unique local stack 
frame created each time they are called. Local stack frames for methods always 
bwe the handle SELF as the last parameter. Local stack frames for procedures 
and functions that are not at the outer most level will contain a Static link 
pointing to the stack frame of the procedure they were defined within. This 
allows that local procedure to access variables defined in it's parent 
procedure. When a local procedure is passed as a procedure parameter, this 
static link is also passed. Clascal methods, procedures and functions declared 
in the interface of a unit and procedures declared in the outer most level of 
the main program never contain a static link. They don't have to since their 
parent procedure is the main program whose stack frame is always referenced by 
the A5 register. 

Finding Where You Are Within a Clascal Hethod - Comparing Source to Object Code 

Here is an example of a Clascal Method. 

PROCEDURE TSanView. housePress(wHj«LPt. LPoint); 
VfiR panel: TPanel; 

pickSelection: TPickSelection; 

pickedBox: TBox; 

sketchSelection: TSketchSelection; 

theKind: INTEGER; 
BEGIN 

<$IFC fTracc}BP(1Q);{$ENDC} 



<$IFC fTiace)£P;{$ENDC> 
END; 

A method is similar to a procedure or function call. The runtime environment 
for the method includes a stack frame containing information used in that 
particular call of the method. The stack frame contains a place to store all 
the local variables and parameters to the method. It also contains information 
about the procedure that called the method. This is the caller's return 
address and the location of the caller's stack frame. You can use this stack 
frame information to look around on the stack and inspect the local variables 
of all methods in the call chain. The local stack frame of TSamView. MousePress 
can be found on page two of this section. Notice where the particular 
parameters and local variables for this method ended up in the stack frame. To 
understand what code is generated for each method source statement, you can use 
compiler options to crest* a listing of your source along with the assembly 



language format of the code generated. The use of these compiler options is 
(documented in the 3.0 iorkshop manuals. After you study a fen examples of this 
Jhile looking at the actual code with LisaBug, you will find it is not that 
nard to figure out what line of code you are executing within a particular 
method. 

Using IL (((AHandle))) to See What Handle You Have or If You Have a Handle 

You can find out if a certain address is a handle, or if you have a handle to 
the correct thing. In LisaBug, you can continue to add levels of indirection 
to IL of that address until you get to the CREATE (NEV) method of some class. 
You will get there if you have a handle then the name of that class will be 
listed by LisaBug. You can do this with an address you key in or with a 
Register. A handle points to a master pointer which points to an object, the 
first field of the object points to the method table for that object. The 
first entry in that table points to the CREATE (NEtf) method. 

that It Probably Heans fhen You Call a Method You Did Not Expect to Call 

If you see an object or method in your stack crawl that makes no sense, you may 
have performed a coercion, assigning one handle to another, and ended up with 
an object of a different type than you intended to have. This indicates a bug 
in the logic of your program that can be confusing to find while debugging. If 
you have range checking turned on {?R+} these errors will be caught by the 
system when they happen except when a coercion is done by passing a handle as 
the actual parameter to a formal VAR parameter. 



y** 



in Hassles and the NV Bug 



By entering LisaBug through the ToolKit debugger, you are forced to enter while 
executing code in the domain of your application. This means the symbols you 
want to see, the methods of your application, will be available in LisaBug. If 
you enter LisaBug in Domain 0, you will notice that it does not know about your 
symbols. The ToolKit debugger saves you from this type of hassle except for 
the NV Bug. This is a bug in LisaBug that occurs when one of your procedures 
contains the characters 'NV' next to each other in that order and this 
combination is also on a word boundary. LisaBug suddenly thinks it has found a 
link instruction, or something, and for some strange reason, this makes LisaBug 
forget all the rest of the symbols in that segment! If you ever enter LisaBug 
from the ToolKit debugger and it doesn't know about your program symbols, that 
is probably the problem. The solution is to rename the procedure containing 
the NV. 

Strategy then You Crash and Fall into LisaBug 

First do a Stack Crawl to get an idea of where you are. You can also do an E. 
of PC-20 to look at the code surrounding the crash. If you have an address 
error or something and you need to figure what source statement you are 
executing in your method, look through the code using IL while looking at a 



source listing of the method. A paper listing helps at this point! If you 
need to find out the values of any variables, you can access then as offsets 
from the various stack frames found in stack crawl. Finding out the values of 
variables in an object can be done using InspectObject within the ToolKit 
debugger or by poking around in memory with Lisabug using the information 
presented in this document about the format of things. Further documentation 
on LisaBug oommands can be found in the Workshop Manual. 

TioMts of Info 

The top two digits of any address divided by 2 gives you the Lisa Segment 
number. LDSN 1 - D6 & D7 (Seg 107), LDSN 2 = DB (Seg 106)... FO = the 
Clipboard segment (Seg 120). DA * the start of your document (Seg 109). 



Process Address Space Layout 



Seg * 


User Mode 


Seg * 



85 

100 
101 
102 
103 

107 
Trap (1) 


System Mode 





unavailable 




1 


Code seg (future) 




• 






17 


1st User Code Seg 








Supervisor's Stack 




SysGlboal 




Systocal 


106 


Last user code Seg 




107 


LDSN 1 








122 


LOSN 16 


124 
125 

126 
127 


123 


Stack 


124 


Shared IU Global Data 


125 


Screen 


Screen 


126 


unavailable 


1/0 Space 


127 


Unavailable 


Pron Access 



Hardware Segmentation: 24 bit address - 7 bit seg* and 17 bit offset 



